home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Taifun / Taifun 205 (1992-06-10)(Manewaldt, A.)(DE)(PD).zip / Taifun 205 (1992-06-10)(Manewaldt, A.)(DE)(PD).adf / KFrac / KFrac.doc < prev    next >
Text File  |  1992-06-06  |  13KB  |  311 lines
  1. ==============================================================================
  2. ==============================================================================
  3. ===         KFrac V1.12, written in 1991-92 by Andreas 'AK' Ralph Kleinert ===
  4. ===                                                                        ===
  5. ===                   - A little Fractalgenerator -                        ===
  6. ===                                                                        ===
  7. ===           Release Date (minor Revision) : 17.04.1992                   ===
  8. ===                                                                        ===
  9. ===                   (ALSO RUNABLE UNDER OS V2.04)                        ===
  10. ===                                                                        ===
  11. ==============================================================================
  12. ===                        ( F R E E W A R E )                             ===
  13. ==============================================================================
  14. ===                                                                        ===
  15. ===                       (c) 1991-92 by Andreas Ralph Kleinert            ===
  16. ===                                   Grube Hohe Grethe 23                 ===
  17. ===                                   W-5900 Siegen 1                      ===
  18. ===                                   Germany                              ===
  19. ===                                                                        ===
  20. ==============================================================================
  21. ==============================================================================
  22.  
  23.    KFrac V1.12 is FREEWARE. Nevertheless I never deny any kind of "presents"
  24.    like money for my work (see the address above).
  25.    (KFrac is no longer PUBLIC DOMAIN.)
  26.    So KFrac is FREEWARE and it is therefore freely distributable, but I
  27.    demand, that possible copy-fees are not very much higher than the real
  28.    costs.
  29.    I also do reserve me all rights to this product ("All rights reserved.").
  30.    This program is not PUBLIC DOMAIN, although it is freely distributable.
  31.  
  32.          --- Documentationfileversion : KFrac-V2.11-A-1504-92 ---
  33.  
  34. =============================================================================
  35. = DESCRIPTION :                                                             =
  36. =============================================================================
  37.  
  38.    The first version of KFrac has been written in July 1991
  39.    by Andreas 'AK' Ralph Kleinert. Other versions followed.
  40.    This is now an optimized and modified version from April 1992.
  41.  
  42.    The first version of this program was partially developed during a
  43.    'project week' at the G.A.L., Siegen. Thanks to all, who helped me to
  44.    write the first version of this program and to fix it's (many) bugs !!!
  45.    Explicitely thanks go to Mr. Schnell, Steffen Dingel and
  46.    Rene Koch, who initiated and organized our project about
  47.    'chaos' (fractals and their meanings) !
  48.  
  49.    NOTE :
  50.    ======
  51.  
  52.           This program is FREEWARE, so it is allowed to distribute
  53.           it without any restrictions, except, that only a *small*
  54.           fee is charged (if necessary).
  55.           The 'ak_gen0.libray', used by this program, is also
  56.           FREEWARE (V35.21, see 'ak_gen0.library'.doc !)
  57.           The program also uses the 'mathieeedoubbas.library' and the
  58.           'mathieeedoubtrans.library', which are available on every
  59.           Workbench-Disk (V1.2-V2.04).
  60.  
  61.           Address :
  62.           =========
  63.  
  64.                    Andreas R. Kleinert
  65.                    Grube Hohe Grethe 23
  66.                    W-5900 Siegen 1   
  67.                    Germany   
  68.  
  69.           Donations and suggestions are always welcome !
  70.           You may also write to me, if you want to know more about
  71.           me or my programs, but don't forget to send enough money
  72.           for postage/packing !
  73.  
  74.           PLEASE write me, if you like this program, tell me which
  75.           version you're using and what you would like to have impro-
  76.           ved !!!
  77.  
  78.    Technical information :
  79.    =======================
  80.  
  81.     - KFrac uses the original AmigaIEEE-Routines with double precision
  82.       (mathieeedoubbas.library, mathieeedoubtrans.library)
  83.     - KFrac also uses the 'ak_gen0.library' V34.xx (or above)
  84.     - KFrac has been written in SAS/C V5.10a/b
  85.     - KFrac has been programmed under OS V2.04 (since V1.02)
  86.  
  87.    WARNING :
  88.    =========
  89.  
  90.     Don't start KFrac via the CLI-/Shell-Command "Run", because
  91.     this will cause serious troubles for KFrac AND the CLI.
  92.     KFrac doesn't open its own CLI-Window, but uses the active
  93.     one, so two tasks would have to share the same window.
  94.     You may open a new Shell instead, and then start KFRac, if
  95.     you would like to multitask while running KFrac.
  96.     But note : The Mousebuttons are checked DIRECTLY, so it
  97.     makes no matter, if KFrac's window is active, or not.
  98.  
  99.    Possibilities :
  100.    ===============
  101.  
  102.    Up to this version you have the possibility to generate the
  103.    following types of fractals :
  104.  
  105.     1) Julia-Sets
  106.     2) Mandelbrot-Sets ("Apfelmaennchen")
  107.     3) Feigenbaum
  108.     4) Quadranians     (just a kind of play-around by me)
  109.  
  110.    Background :
  111.    ============
  112.  
  113.     ==========================================
  114.     = About 'Mandelbrot'- and 'Julia'-Sets : =
  115.     ==========================================
  116.  
  117.      Mandelbrot and Julia are both some ways of a partially display
  118.      of an object, which depends on 4 parameters.
  119.  
  120.      Mandelbrot uses fix 'z_re' and 'z_im', but displays the fractal
  121.      as a graphic, where the x- and y-position depend from 'c_re'
  122.      and 'c_im'.
  123.  
  124.      Julia uses fix 'c_re' and 'c_im', but displays the fractal
  125.      as a graphic, where the x- and y-position depend from 'z_re'
  126.      and 'z_im'.
  127.  
  128.      Both use the same (recursive) algorithm, which looks as
  129.      follows :
  130.  
  131.       z_n+1 = z_new = z_n^2 - c
  132.  
  133.      This is transferred to a 'complex platform', where z_n and c
  134.      are complex (imaginary) numbers :
  135.  
  136.       z_re_new = z_re^2 - z_im^2 - c_re
  137.       z_im_new = 2*z_re*z_im - c_im
  138.  
  139.      With this formula it is possible to describe the behaviour of
  140.      the above recursive algorithm in a 2-dimensional way, where
  141.      'convergency' and 'divergeny' (don't know if these are the right
  142.      words) are represented and marked with different colors (each
  143.      pixel).
  144.  
  145.    Usage :
  146.    =======
  147.  
  148.     Julia-Set :
  149.     ===========
  150.  
  151.      'ze_re' and 'ze_im' determine, which part of the fractal,
  152.      which results out of the 'c_re' and the 'c_im' value, is
  153.      shown.
  154.      'ze_re' influences the X-Coordinates, 'z_im' the Y-Coordinates.
  155.      The 'Iteration' value determines the depth - the 'clearness' -
  156.      of the picture, and the 'width' and 'height' are responsible
  157.      for the size of the picture.
  158.      Speed may be increased by selecting less colors, a smaller size
  159.      or less 'Iterations'.
  160.  
  161.     Mandelbrot-Set :
  162.     ================
  163.  
  164.      'c_re' and 'c_im' determine, which part of the fractal,
  165.      which is always similarily, is shown.
  166.      'c_re' influences the X-Coordinates, 'c_im' the Y-Coordinates.
  167.      The 'Iteration' value determines the depth - the 'clearness' -
  168.      of the picture, and the 'width' and 'height' are responsible
  169.      for the size of the picture.
  170.      Speed may be increased by selecting less colors, a smaller size
  171.      or less 'Iterations'.
  172.  
  173.     Feigenbaum :
  174.     ============
  175.  
  176.      This implementation seems to be a little bit silly, but I can't
  177.      find a bug. The following kinds of values make no problems
  178.      (I hope) :
  179.  
  180.        k_min  : 1.9xxxxxxxxx
  181.        k_max  : 3.5xxxxxxxxx
  182.        q_0    : 0.2xxxxxxxxx
  183.        iter.  : 50
  184.        skip   : 10
  185.  
  186.        x      : 640
  187.        y      : 256
  188.  
  189.        colors : N
  190.  
  191.      The mysterious thing is, that there is really *no* result for
  192.      for        k_min =  1.9, k_max =  3.5 and q_0  = 0.2
  193.      and no for k_min >> 1.9, k_max >> 3.5 and q_0 >> 0.2
  194.      but for    k_min = 1.9xxxxxx,
  195.                 k_max = 3.5xxxxxx,
  196.                 q_0   = 0.2xxxxxx THERE IS A RESULT !!!
  197.  
  198.      Don't know why this happens, but I *really* don't have the
  199.      interest to check it out "by hand". If there's an error, I will
  200.      perhaps find it sometime in the future, if not, then its OK,
  201.      anyway.
  202.  
  203.  
  204.    Speed-Increase :
  205.    ================
  206.  
  207.      If you're using a screen with more than 4 colors you may speed
  208.      up KFrac by using Amiga-M / Amiga-N to put an other Screen (with
  209.      less colors) in the foreground. This will greatly speed up
  210.      the calculating time, because the DMA-access of the processor
  211.      will no longer be slowed down by the Customchips. (This effect
  212.      is not so high if you have a lot of FAST-Mem or a Turbo-Board.)
  213.  
  214.      If you own a Turbo-Board, which includes a 68881/68882 Math-
  215.      Co-CPU, speed will automatically increase a lot, because the
  216.      standard math/libraries, used by this program, do support
  217.      those.
  218.  
  219.  
  220.    Enjoy its using and begin to experimentate !!!
  221.  
  222. =============================================================================
  223. = VERSION-"HISTORY" :                                                       =
  224. =============================================================================
  225.  
  226.  pre V1.0 :
  227.  
  228.   - work versions, not released (constructed mainly during a 'project week')
  229.  
  230.  ---------------------------------------------------------------------------
  231.  
  232.  V1.0 :
  233.  
  234.   - initial release
  235.  
  236.  ---------------------------------------------------------------------------
  237.  
  238.  V1.01 :
  239.  
  240.   - modified for use with "ak_gen0.library" (instead of "ak.library")
  241.   - now support of double precision instead of single precision
  242.  
  243.  ---------------------------------------------------------------------------
  244.  
  245.  V1.02 :
  246.  
  247.   - improved speed of main algorithmus
  248.   - making use of pragmas
  249.   - making use of special code optimizations
  250.   - some other small enhancements
  251.   - now the number of colors used is changeable (2, 4, 8, 16)
  252.  
  253.  ---------------------------------------------------------------------------
  254.  
  255.  V1.10 :
  256.  
  257.   - improved and "debugged" the documentation in- and outside the program
  258.   - integrated three new types of fractals :
  259.  
  260.      - Mandelbrot (also called "Apfelmaennchen")
  261.      - Feigenbaum (hope, it functions correctly)
  262.      - Quadranian (it bases on rectangles, and produces a strange kind of
  263.                    pattern -> not one of the 'usual' fractals)
  264.  
  265.   - improved some less important things
  266.  
  267.  ---------------------------------------------------------------------------
  268.  
  269.  V1.12 :
  270.  
  271.   - This version is no longer PUBLIC DOMAIN, but FREEWARE
  272.   - now its possible to save the Fractals as IFF-ILBM-Graphics
  273.     (uncompressed and compressed, as you like)
  274.   - some small speed improvements (Yeeeaaaahh !!! :)
  275.   - added some Menus (to the Display-Screen), so that Intuition
  276.     now is supported much more better
  277.   - fixed some things in the docs (this one you are reading now) and
  278.     in the program-internal docs
  279.   - this release makes use of "ak_gen0.library" V35.21
  280.     (V34.xx still supported)
  281.  
  282. -----------------------------------------------------------------------------
  283. -----------------------------------------------------------------------------
  284.  
  285.    Known Bugs :
  286.  
  287.     There are no known bugs, execpt of these already mentioned above :-)
  288.  
  289. -----------------------------------------------------------------------------
  290. -----------------------------------------------------------------------------
  291.  
  292.    Possible enhancements in (possible :) future versions :
  293.  
  294.      - IFF-ACBM-Support       (save pictures for BASIC)
  295.      - more Intuition-Support (maybe under use of 'gadtools.library' V37+)
  296.  
  297.      Send me BUG-Reports !
  298.  
  299. =============================================================================
  300. = COPYRIGHTS :                                                              =
  301. =============================================================================
  302.  
  303. =============================================================================
  304. =   "KFrac"                                                                 =
  305. =   (c) 1991-92 by Andreas R. Kleinert.                                     =
  306. =   FREEWARE. All rights reserved.                                          =
  307. =============================================================================
  308. =   Copyrights of other mentioned products/programs are to find in the      =
  309. =   manuals of these and are not listed explicitely at this place here.     =
  310. =============================================================================
  311.